home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / libblas / trmv.z / trmv
Encoding:
Text File  |  2002-10-03  |  5.0 KB  |  124 lines
  1. TRMV(3F)                                              Last changed: 11-2-98
  2.  
  3.  
  4. NNAAMMEE
  5.      SSTTRRMMVV, DDTTRRMMVV, CCTTRRMMVV, ZZTTRRMMVV - Multiplies a real or complex vector by a
  6.      real or complex triangular matrix
  7.  
  8. SSYYNNOOPPSSIISS
  9.      Real
  10.  
  11.         CCAALLLL SSTTRRMMVV ((_u_p_l_o,, _t_r_a_n_s,, _d_i_a_g,, _n,, _a,, _l_d_a,, _x,, _i_n_c_x))
  12.  
  13.      Double precision
  14.  
  15.         CCAALLLL DDTTRRMMVV ((_u_p_l_o,, _t_r_a_n_s,, _d_i_a_g,, _n,, _a,, _l_d_a,, _x,, _i_n_c_x))
  16.  
  17.      Complex
  18.  
  19.         CCAALLLL CCTTRRMMVV ((_u_p_l_o,, _t_r_a_n_s,, _d_i_a_g,, _n,, _a,, _l_d_a,, _x,, _i_n_c_x))
  20.  
  21.      Double complex
  22.  
  23.         CCAALLLL ZZTTRRMMVV ((_u_p_l_o,, _t_r_a_n_s,, _d_i_a_g,, _n,, _a,, _l_d_a,, _x,, _i_n_c_x))
  24.  
  25. IIMMPPLLEEMMEENNTTAATTIIOONN
  26.      IRIX systems
  27.  
  28. DDEESSCCRRIIPPTTIIOONN
  29.      SSTTRRMMVV and DDTTRRMMVV multiply a real vector by a real triangular matrix.
  30.  
  31.      CCTTRRMMVV and ZZTTRRMMVV multiply a complex vector by a complex triangular
  32.      matrix.
  33.  
  34.      These routines perform one of the following matrix-vector operations:
  35.  
  36.           _x <- _A_x
  37.                 _T
  38.           _x <- _A _x
  39.                 _H
  40.           _x <- _A _x (CCTTRRMMVV, ZZTTRRMMVV only)
  41.             _T                         _H
  42.      where _A  is the transpose of _A, _A  is the conjugate transpose of _A, _x
  43.      is an _n-element vector, and _A may be either a unit or nonunit _n-by-_n
  44.      upper or lower triangular matrix.
  45.  
  46.      These routines have the following arguments:
  47.  
  48.      _u_p_l_o      Character*1.  (input)
  49.                Specifies whether the matrix is upper or lower triangular,
  50.                as follows:
  51.  
  52.                _u_p_l_o = 'U' or 'u':  _A is an upper triangular matrix.
  53.                _u_p_l_o = 'L' or 'l':  _A is a lower triangular matrix.
  54.  
  55.      _t_r_a_n_s     Character *1.  (input)
  56.                Specifies the operation to be performed, as follows:
  57.  
  58.                _t_r_a_n_s = 'N' or 'n':  _x <- _A_x
  59.  
  60.                                           _T
  61.                _t_r_a_n_s = 'T' or 't':  _x <- _A _x
  62.  
  63.                                           _T                           _H
  64.                _t_r_a_n_s = 'C' or 'c':  _x <- _A _x (SSTTRRMMVV, DDTTRRMMVV), or _x <- _A _x
  65.                (CCTTRRMMVV, ZZTTRRMMVV)
  66.  
  67.      _d_i_a_g      Character *1.  (input)
  68.                Specifies whether _A is unit triangular, as follows:
  69.  
  70.                _d_i_a_g = 'U' or 'u': _A is assumed to be unit triangular.
  71.                _d_i_a_g = 'N' or 'n': _A is not assumed to be unit triangular.
  72.  
  73.      _n         Integer.  (input)
  74.                Specifies the order of matrix _A.  _n >= 0.
  75.  
  76.      _a         Array of dimension (_l_d_a,_n).  (input)
  77.                SSTTRRMMVV: Real array.
  78.                DDTTRRMMVV: Double precision array.
  79.                CCTTRRMMVV: Complex array.
  80.                ZZTTRRMMVV: Double complex array.
  81.  
  82.                Before entry with _u_p_l_o = 'U' or 'u', the leading _n-by-_n
  83.                upper triangular part of array _a must contain the upper
  84.                triangular matrix.  The strictly lower triangular part of _a
  85.                is not referenced.
  86.  
  87.                Before entry with _u_p_l_o = 'L' or 'l', the leading _n-by-_n
  88.                lower triangular part of array _a must contain the lower
  89.                triangular matrix.  The strictly upper triangular part of _a
  90.                is not referenced.
  91.  
  92.                When _d_i_a_g = 'U' or 'u', these routines assume that all
  93.                elements of array _a that represent diagonal elements of
  94.                matrix _A are 1.  In this case, neither of these routines
  95.                will reference any of the diagonal elements.
  96.  
  97.      _l_d_a       Integer.  (input)
  98.                Specifies the first dimension of _a as declared in the
  99.                calling program.  _l_d_a must be at least MMAAXX(1,_n).
  100.  
  101.      _x         Array of dimension 1+(_n-1) * |_i_n_c_x|.  (input and output)
  102.                SSTTRRMMVV: Real array.
  103.                DDTTRRMMVV: Double precision array.
  104.                CCTTRRMMVV: Complex array.
  105.                ZZTTRRMMVV: Double complex array.
  106.                Contains the vector _x.  On exit, the transformed vector
  107.                overwrites array _x.
  108.  
  109.      _i_n_c_x      Integer.  (input)
  110.                Specifies the increment for the elements of _x.  _i_n_c_x must
  111.                not be 0.
  112.  
  113. NNOOTTEESS
  114.      These routines are Level 2 Basic Linear Algebra Subprograms (Level 2
  115.      BLAS).
  116.  
  117.      When working backward (_i_n_c_x < 0), each routine starts at the end of
  118.      the vector and moves backward, as follows:
  119.  
  120.           _x(1-_i_n_c_x * (_n-1)), _x(1-_i_n_c_x * (_n-2)), ..., _x(1)
  121.  
  122. SSEEEE AALLSSOO
  123.      This man page is available only online.
  124.